Kleine grafische beeldschermen en MicroPython 

Deze tekst gaat over kleine OLED schermen met een SSD1306 aansturing en hoe we die gebruiken met 
MicroPython. De voorbeelden zijn getest met MicroPython versie 1.20.0 en met verschillende 
controllers. Voor de programmering gebruiken we Thonny. Meer informatie over MicroPython en 
Thonny vind je in onze cursus MicroPython. Die vind je op onze blog, zie onderaan deze tekst. 


SSD1306 schermen zijn goedkoop en klein, maar door de scherpte van het beeld kan er toch veel 
informatie op. De grafische mogelijkheden komen ook aan bod. 


De resolutie wordt uitgedrukt in pixels: een 128x64 scherm heeft horizontaal 128 pixels naast elkaar 
en verticaal 64 pixels onder elkaar. Een punt op het scherm duid je aan met zijn coördinaten (a, b): a 
is het aantal pixels vanaf de linkerrand en b vanaf de bovenrand. 


(0,0) a 


hoogte: n pixels 


breedte: m pixels 


De kleuren zijn wit, geel, blauw of geel-blauw. Stel je niet te veel voor van de tweekleuren OLED: Het 
bovenste stukje van het scherm is altijd geel, de rest altijd blauw. De grootte van het scherm is de 
lengte van een diagonaal in inches. Hieronder zie je van enkele populaire schermen de afmetingen: 


Diagonaal Breedte Hoogte 
0.42” 72 40 
0.66” 64 48 
0.96” 128 64 
13“ 128 64 
0.91” 128 32 


SSD1306 met een ESP8266 controller 
MicroPython ondersteunt SSD1306 beeldschermen alleen voor ESP8266 en de compatibele ESP8285. 
Meestal gebruik je hiervoor een I2C interface. Kijk nog eens naar de cursus Micro-Python voor het 


gebruik van die poort. De aansturing gebeurt door MicroPython library ssd1306. Het voorbeeld 
hieronder toont de verschillende stappen. 


e We definiëren i2c met klasse 12C uit library machine. Pas deze regel aan als jouw systeem 
andere GPIO’s gebruikt voor de 12C-poort. 
e We definiëren display met klasse SSD1306_12C. De parameters zijn de schermresolutie en de 


juist gedefinieerde i2c. 
e De basisbewerkingen zoals methode display.text schrijven informatie, naar het 
schermgeheugen. Met display.show() toon je het geheugen op het scherm. 


De basisbewerkingen 


Met deze library kan je geen cirkels tekenen! 


Een digitale klok 
De klok in het voorbeeld hieronder toont de tijd, datum en uur, op een SSD-scherm. De klok leest de 
tijd uit de RTC (real time clock) van de controller. Thonny configureert de RTC bij het programmeren 


van de controller. 


display.text('RTC klok',0,0,1) 
display.text('(c) Dirk',0,20,1) 
display.show() 

utime.sleep(2) 


rtc = RTC() 
sec0 = 0 
while True: 
nu = rtc.datetime() 


jaar = nu[0] 
maand = nu[1] 
dag = nu[2] 


uur = nu[4] 

minuut = nu[5] 

seconde = nu[6] 

if (seconde |= sec6): 
uurstr = "%02u:%02u:%02u" %(uur, minuut, seconde) 
datumstr = "%02u/%02u/%04u" %A(dag, maand, jaar) 
secô = seconde 
display.fill(0) 
display.text(uurstr,20,18,1) 
display.text(datumstr,20,56,1) 
display.show() 

display.show() 


De library heeft geen functie om getallen op het scherm te zetten, alleen strings (stukken tekst). 
Strings uurstr en datumstr zijn opgebouwd met variabelen uur, minuut, … Meer informatie over deze 
constructie vind je in hoofdstuk 8 van de cursus. 


Andere Controllers en de Ssd1306 


Op internet vind je libraries voor SSD1306 OLED’s die werken met andere controllers. Meestal bestaan 
die uit een bestand met de naam ssd1306.py. Een goed voorbeeld vind je op: 


http://electronoobs.com/eng arduino tut138.ph 


Download bestand ssd1306.py en bewaar het in het flash-geheugen van de controller. Deze library 
kent dezelfde basisbewerkingen als de library voor de ESP8266. Je moet alleen is de definitie van de 
12C-poort aanpassen, die is bij elk type controller verschillend. Hieronder zie je een voorbeeld voor de 
RP2040 controller: 


from machine import Pin, I2C 
import ssd1306 


i2c = I2C(@, sda=Pin(4), scl=Pin(5)) 
display = ssd1306.SSD1306 12C(128, 64, i2c) 


display.text( ‘Hello, World!', @, 0, 1) 


display.show() 


gfx.py: de grafische library van Adafruit 
Adafruit heeft ooit een grafische library voor MicroPython gemaakt, als uitbreiding van de grafische 
mogelijkheden van de gangbare ssd1306 libraries. Je vindt die op Github: 


https://github.com/adafruit/micropython-adafruit-gfx 


Adafruit noemt de library deprecated, d.w.z. dat deze software niet meer ondersteund wordt, ze 
gebruiken nu CircuitPython voor hun producten. Desondanks is deze library nog perfect bruikbaar. 


De voornaamste functies van gfx zijn: 


graphics.line(®, @, 127, 63, 1) # lijn van (0,0) tot (127,63) 

graphics.rect(10, 10, 107, 43, 1) # rechthoek met hoekpunten (10,18), (117,53), kleur=1 
graphics.rect(10, 10, 107, 43, 1) # rechthoek met hoekpunten (10,10), (107,43), kleur=1 
graphics.fill rect(10, 10, 107, 43, 1) # gevulde rechthoek 

graphics.circle(30, 33, 10, 1) # cirkel met middelpunt (30, 33), straal 10, kleur=1 
graphics.fill circle(30, 33, 10, 1) # gevulde cirkel 

graphics.triangle(10, 10, 77, 58, 43, 60, 1) # driehoek met hoekpunten (10,10), (77,50), 


(43,60), kleur=1 
graphics.fill triangle(1e, 10, 77, 50, 43, 60, 1) # gevulde driehoek 
graphics.text(‘Hello World', @, 0, 1) # zet tekst op (O, 0), kleur 1 


De meeste functies van gfx vind je ook in de ssd1306 library. Alleen functie circle is nieuw, we gebruiken 
die in volgend voorbeeld. 


Toepassing: een analoge klok 


Dit programma maakt een analoge klok op een Schermpje met resolutie 128x64. Dit kan je aanpassen 
met variabelen ho en br. De wijzerplaat vormen we met cirkeltjes die de uren voorstellen, het cirkeltje 
van 12 uur is vervangen door getal 12. Het programma leest constant de RTC uit, als minuut verandert 
dan wissen we het scherm en met de nieuwe gegevens bouwen we het terug op. 


De wijzerplaat: 

De 12 uren op de wijzerplaat liggen op een cirkel met straal r. Ze verdelen de cirkel in 12 stukken. De 
hoek (a op de figuur) tussen 12 uur en 1 uur is 360°/12 = 30° = 1/6 radialen. De hoek tussen 12u en 7u 
is 7n/6 


In rechthoekige driehoek MTE is 


ME =r (de straal van de wijzerplaat) 
Hoek a = n/6 

MT = r.cos(a) = r.cos(n/6) 

TE =r.sin(a) =r.sin(n/6) 

M = (mx, my) 


mx is gemeten vanaf de linkerrand, my vanaf de bovenrand, de coördinaten van 1 uur zijn dan 
(mx + r.sin(rt/6), my - r.cos(nt/6)) 
De andere uren vind je op dezelfde manier, alleen de hoek verandert. 


De grote wijzer: 

Die geeft minuten aan. De 60 minuten verdelen de cirkel in hoekjes van 360°/60 = 6° = 1/30 radialen. 
Bij X minuten na het uur heeft de grote wijzer een hoek van X.n/30 radialen. De grote wijzer heeft 
lengte rm, het beginpunt is (mx, my), het eindpunt is (mx+rm.sin(X.71/30), my-rm.cos(X.n1/30)). We 
tekenen die met functie line. 


De kleine wijzer: 
X uur en Y minuten kan je schrijven als (X + Y/60) uur. Voor dat uur is de hoek die de kleine wijzer 
maakt gelijk aan: (X+Y/60). 1/6. Het eindpunt van de kleine wijzer is 


(mx + sin((X+Y/60). 71/6), my - cos((X+Y/60). 71/6)) 


Hieronder staat het volledige programma. 
analoge-klok.py 


# 
# # 
# # 
# 5 juli 2023 # 
# Dirk Ghysels # 
# https://ghysels-iot.blogspot.com # 

# 


from machine import Pin, I2C, RTC 

import ssd1306, gfx, time, math 

br = 128 

ho = 64 

i2c = I2C(@, sda=Pin(4), scl=Pin(5)) 
display = ssd1306.SSD1306 12C(128, 64, i2c) 
graphics = gfX.GFX(128, 64, display.pixel) 
FEC = RTC) 

pi = 3.14159 


10 juni 2023 
Dirk Ghysels 
https://ghysels-iot.blogspot.com 


